<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->

<title>addnstr</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_002_001_231">&nbsp;</a>NAME</h4><blockquote>
addnstr, addstr, mvaddnstr, mvaddstr, mvwaddnstr, mvwaddstr waddnstr, waddstr
- add a string of multi-byte characters without rendition to a window and
advance cursor
</blockquote><h4><a name = "tag_002_001_232">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

#include &lt;<a href="curses.h.html">curses.h</a>&gt;

int addnstr(const char *<i>str</i>, int <i>n</i>);

int addstr(const char *<i>str</i>);

int mvaddnstr(int <i>y</i>, int <i>x</i>, const char *<i>str</i>, int <i>n</i>);

int mvaddstr(int <i>y</i>, int <i>x</i>, const char *<i>str</i>);

int mvwaddnstr(WINDOW *<i>win</i>, int <i>y</i>, int <i>x</i>, const char *<i>str</i>, int <i>n</i>);

int mvwaddstr(WINDOW *<i>win</i>, int <i>y</i>, int <i>x</i>, const char *<i>str</i>);

int waddnstr(WINDOW *<i>win</i>, const char *<i>str</i>, int <i>n</i>);

int waddstr(WINDOW *<i>win</i>, const char *<i>str</i>);
</code>
</pre>
</blockquote><h4><a name = "tag_002_001_233">&nbsp;</a>DESCRIPTION</h4><blockquote>
These functions write the characters of the string <i>str</i> on the current or
specified window starting at the current or specified position using
the background rendition.
<p>
These functions advance the cursor position.  These functions perform
special character processing.  These functions perform wrapping.
<p>
The
<i>addstr()</i>,
<i>mvaddstr()</i>,
<i>mvwaddstr()</i>
and
<i>waddstr()</i>
functions are similar to calling
<i><a href="../xsh/mbstowcs.html">mbstowcs()</a></i>
on <i>str</i>, and then calling
<i><a href="addwstr.html">addwstr()</a></i>,
<i><a href="mvaddwstr.html">mvaddwstr()</a></i>,
<i><a href="mvwaddwstr.html">mvwaddwstr()</a></i>
and
<i><a href="waddwstr.html">waddwstr()</a></i>,
respectively.
<p>
The
<i>addnstr()</i>,
<i>mvaddnstr()</i>,
<i>mvwaddnstr()</i>
and
<i>waddnstr()</i>
functions use at most <i>n</i> bytes from <i>str</i>.  These functions add the
entire string when <i>n</i> is -1.  These functions are similar to calling
<i><a href="../xsh/mbstowcs.html">mbstowcs()</a></i>
on the first <i>n</i> bytes of <i>str</i>, and then calling
<i><a href="addwstr.html">addwstr()</a></i>,
<i><a href="mvaddwstr.html">mvaddwstr()</a></i>,
<i><a href="mvwaddwstr.html">mvwaddwstr()</a></i>
and
<i><a href="waddwstr.html">waddwstr()</a></i>,
respectively.
</blockquote><h4><a name = "tag_002_001_234">&nbsp;</a>RETURN VALUE</h4><blockquote>
Upon successful completion, these functions return OK.  Otherwise, they return
ERR.
</blockquote><h4><a name = "tag_002_001_235">&nbsp;</a>ERRORS</h4><blockquote>
No errors are defined.
</blockquote><h4><a name = "tag_002_001_236">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="addnwstr.html">addnwstr()</a></i>,
<i><a href="../xsh/mbstowcs.html">mbstowcs()</a></i>
(in the <b>XSH</b> specification), 
<i><a href="curses.h.html">&lt;curses.h&gt;</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
